home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / tlayr10 / tilelayr.doc < prev    next >
Text File  |  1995-04-19  |  5KB  |  150 lines
  1.                ╔══════════════════════════════════════════════╗
  2.                ║                                              ║██
  3.                ║              TILE LAYER UTILITY              ║██
  4.                ║                 version 1.00                 ║██
  5.                ║                                              ║██
  6.                ║        programmed by gaggi@cs.unibo.it       ║██
  7.                ║                                              ║██
  8.                ╚══════════════════════════════════════════════╝██
  9.                  ████████████████████████████████████████████████
  10.  
  11.  
  12. Hello boys, I am here again!
  13. I am proud to present my first C++ written application. It is a simple
  14. tile-based world editor with a nice graphical user interface (Uhm... this is 
  15. just my opinion :) ).
  16.  
  17. My world editor is very simple to use, but anyway here are a few
  18. explanations about the interface and its commands.
  19.  
  20. The interface looks like this ...
  21.  
  22. ┌────────────────────────────┐   ┌─────┐
  23. │ (1) Edit window            │   │     │ (2) Tile set
  24. │                            │   │     │
  25. │                            │   └─────┘
  26. │                            │   <- ->   (3) Tile set control button
  27. │                            │     
  28. │                            │     |
  29. │                            │   <- ->   (4) Edit window scroll buttons
  30. │                            │     |
  31. │                            │   ┌─────┐
  32. │                            │   ┌─────┐ (5) Menu buttons
  33. │                            │   ┌─────┐
  34. │                            │   ┌─────┐
  35. └────────────────────────────┘   ┌─────┐
  36.  
  37.  
  38. (1) Edit window
  39. Here is where you put the tiles of your world. If you click the left button
  40. of the mouse the current tile of the loaded tile set will be drawn on the 
  41. edit window and the corresponding index number of the tile will be stored in
  42. the buffer that holds world datas. If you click the right one the tile under
  43. the mouse cursor will be deleted and the value 0xff will be stored in the
  44. buffer.
  45.  
  46. (2) Tile set
  47. It shows the current selected tile of your tile set. If you press any mouse
  48. button on this object you'll see a panel that shows the current tile index
  49. number and the total number of tile in the set.
  50.  
  51. (3) Tile set control buttons
  52. These two buttons are used to change the current selected tile.
  53.  
  54. (4) Edit window scroll buttons
  55. Take a guess Einstein!
  56.  
  57. (5) Menu buttons
  58. Here are the buttons and their corresponding functions:
  59.  
  60. - Load TIL 
  61. This button is used to load a new set of tiles. When you load a new set the
  62. current world will be erased and a new one will be created. The new world
  63. sizes are 20 bytes x 40 lines and the buffer is filled with the value 0xff.
  64.  
  65. - Load WLD
  66. This button is used to load a new world buffer and a new set of tiles.
  67. If no error occurs the current world will be replaced by the new one.
  68.  
  69. - Save WLD
  70. Take a guess again!
  71.  
  72. - Redim
  73. This button is used to set new sizes for the world buffer. I suggest you to use
  74. it before drawing the world, because it doesn't take care of what is stored in
  75. the buffer and what you have drawn before. No adjustement is performed!
  76.  
  77. - WLD info
  78. It shows some piece of information about the world being edited such as:
  79.  
  80.  . The current world sizes (width , height)
  81.  . The current tile set file name
  82.  . The current position of the upper left corner of the edit window in the 
  83.    world buffer
  84.  . The status of the buffer, I mean if it has been modified or not.
  85.  
  86. - Quit
  87. The last guess!
  88.  
  89.  
  90. **** File formats ****
  91.  
  92. - TIL format
  93. BYTE
  94.  0 - 15       ID string "TILE FILE"
  95. 16 - 17       version number
  96. 18            width of a tile
  97. 19            height of a tile
  98. 20 - ...      tiles' datas
  99.  
  100. You can use the converter SPR2TIL provided with this package to convert SPR
  101. files into TIL. 
  102. SPR file format is used in another application I have previously written.
  103.  
  104. You can download it directly from my WWW page at:
  105.  http://www.cs.unibo.it/~gaggi/listofprogs.html
  106.  
  107. or from the FTP site:
  108.  x2ftp.oulu.fi  or  teeri.oulu.fi
  109.  directory: /pub/msdos/programming/utils
  110.  file     : spr_cut.zip
  111.  
  112. Anyway here is the SPR file format:
  113. BYTE
  114.  0                         Sprite 1 bitmap width
  115.  1                         Sprite 1 bitmap height
  116.  2 ... width x height - 1  Sprite 1 bitmap datas
  117.  and so on for sprites 2, 3, 4, 5 ...
  118.  
  119.  
  120. - WLD format
  121. BYTE
  122.  0 - 47       Tile set file name
  123. 48 - 49       World width  
  124. 50 - 51       World height
  125. 52 - ...      World datas
  126.  
  127. In the package you'll find the header files of all modules and the source of
  128. the main module only in order to explain the object hierachy used and the
  129. general architecture of the program.
  130. I don't think I'll release the full source of this work because it is written
  131. in a terrible style half pure C and half C++, plus some bits of in-line
  132. assembly code. I have programmed for months using C and ASM so that I have
  133. some difficulties with the object-oriented programming paradigm:
  134. "bad" habits are hard to eliminate!
  135.  
  136. Anyway take a look at my work and send me your comment and feedback on it.
  137.  
  138. Thank you,
  139.  
  140. Gaggi Nicola
  141. University of Bologna
  142.  
  143. e-mail     : gaggi@cs.unibo.it
  144. WWW page   : http://www.cs.unibo.it/~gaggi
  145. snail-mail : Gaggi Nicola
  146.              Via Gramsci 23
  147.              40050 Quarto Inferiore (BO)
  148.              ITALY
  149. ------------------------------------------------------------
  150.